نمونه کد جاوا
بدون شک یکی از محبوبترین زبانهای برنامهنویسی دنیا که به دلیل چند سکویی (Cross Platform) بودن و همچنین پشتیبانی از ویژگی شئگرایی (OOP) مورد توجه افراد بسیار زیادی در دنیا قرار گرفته است زبان جاوا می باشد ما در ان پست نمونه کد اس ام اس جاوا را برای شما کابران گرانقدر آماده کرده ایم...
در ابتدا کتابخانه را به پروژه خود اضافه کنید. برای استفاده از کتابخانه فایل jar را همراه با کتابخانه گوگل gson به پروژه تان اضافه کنید.
حالا میتوانید در پروژه جاوایی تان از آن استفاده کنید.
برای استفاده از کتابخانه ابتدا یک نمونه از کلاس Raygansms ایجاد می کنید. دقت کنید اطلاعات ورودی مورد نیاز برای سازنده این نمونه نام کاربری و رمز سامانه پیامکی خودتان است. در ادامه هر یک از متدهای آنرا شرح می دهیم.
*احراز هویت (متد getAuthHeader** )**
*این متد رشته مورد نیاز برای احراز هویت (فیلد Authorization) را ایجاد می کند. این متد مقدار رشته ای بر می گرداند.
*مقدار برگشتی متدها (شی Result)
متدهای دیگر کتابخانه (به غیر از getAuthHeader ) از این نوع بر می گردانند. این نوع شامل سه متغییر است. یکی Code از نوع ResultCode و بیانگر موفقیت آمیز بودن عملیات یا شماره خطا است. نوع Message متن نتیجه را مشخص می کند. نوع Result نتیجه مربوط به متد را مشخص میکند و میتواند عدد، رشته و از نوع JSON باشد.
نام پارامتر | نوع پارامتر | توضیحات |
Code | ResultCode | کد نتیجه عملیات |
Message | String | متن نتیجه عملیات |
Result | JsonElement | اطلاعات دیگر عملیات درخواستی |
در کد زیر نمونه کدی برای دریافت اعتبار حساب استفاده شده است. دقت کنید برای اجرا شما باید از کلاس Raygansms یک متغیر ایجاد کرده و متد مربوط به اجرا را در کد فرابخوانید. نتیجه مورد بدست آمده را بررسی کرده و بر اساس خروجی نتیجه مورد نیاز را به کاربر نمایش دهید. برای نمونه کد زیر را مشاهده کنید.
**private** Raygansms **raygansms** = **new** Raygansms( **"username"** , **"password"** ); **private** String[] **Mobiles** = { **"09120000000"** , **"09120000001"** }; **private** RecipientsMessage[] **recipientsMessages** = {}; **private** String[] **MessageIDs** = { **"1"** , **"2"** }; **private** String **PhoneNumber** = **"5000000000"** ; **private** String **UserGroupID** = **"1"** ; **private** Integer **PORT** = 90; **private** String _Hello_ = **"** سلام **"** ; **String** GetPrices() **throws** IOException { Result result = **raygansms****.GetPrices**(); ** if** (result != **null** ) { String text = **"Code:**** \t ****"** + result.getCode() + **"**** \n ****Message:**** \t ****"** + result.getMessage(); ** if** (result.getResult() != **null** ){ ** ** text += **"**** \n ****Result:**** \t ****"** + result.getResult(); ** ** } ** return** text; ** ** } ** return**** null**; }
در ادامه متدهای کتابخانه را شرح می دهیم.
ارسال پیام
1-ارسال پیام گروهی ( متد SendMessage )
از این متد برای ارسال پیام گروهی استفاده می شود. بدیهی است از این پیام برای ارسال پیام تکی نیز میتوان استفاده نمود.
نام پارامتر | نوع پارامتر | توضیحات |
phoneNumber | String | شماره اختصاصی |
message | String | متن پیام ارسالی |
mobiles | String[] | آرایه ای از شماره موبایل ها برای ارسال پیام |
UserGroupID | String | گروه پیام |
SendDateInTimeStamp | Long | تاریخ ارسال پیام به صورتTimeStamp (به ثانیه) |
نمونه کد فراخوانی:
raygansms.SendMessage(PhoneNumber, Hello, Mobiles, UserGroupID, System.currentTimeMillis() / 1000L);
ملاحضات:
در صورتی که تاریخ ارسال، از تاریخ فعلی کمتر باشد یا به عبارتی دیگر از زمان مورد نظر عبور کرده باشید، پیام مورد نظر در لحظه ارسال خواهد شد.
2-ارسال پیام متناظر ( متد SendCorrespondingMessage )
از این متد برای ارسال پیام متناظر استفاده می شود.
نام پارامتر | نوع پارامتر | توضیحات |
phoneNumber | String | شماره اختصاصی |
recipientsMessage | RecipientsMessage[] | آرایه ای از شماره ها و پیام های متناظر |
UserGroupID | String | گروه پیام |
نمونه کد فراخوانی:
raygansms.SendCorrespondingMessage(PhoneNumber, recipientsMessages, UserGroupID);
3-ارسال پیام به پورت خاص ( متد SendMessageToPort )
از این متد برای ارسال پیام به پورت خاص استفاده می شود.
نام پارامتر | نوع پارامتر | توضیحات |
phoneNumber | String | شماره اختصاصی |
recievePortNumber | int | شماره پورت دریافت پیام |
sendPortNumber | int | شماره پورت دریافت پیام |
UserGroupID | String | گروه پیام |
recipientsMessage | RecipientsMessage[] | آرایه ای از شماره ها و پیام های متناظر |
نمونه کد فراخوانی:
raygansms.SendMessageToPort(PhoneNumber, PORT, PORT, UserGroupID, recipientsMessages);
4-مشاهده وضعیت ارسال پیام گروهی ( متد GroupMessageStatus )
از این متد برای واکشی، وضعیت لیست پیام های ارسالی استفاده می شود.
نام پارامتر | نوع پارامتر | توضیحات |
groupMessageId | String | شناسه گروه ارسال پیام |
نمونه کد فراخوانی:
raygansms.GroupMessageStatus(UserGroupID);
5-مشاهده وضعیت ارسال پیام متناظر ( متد CorrespondingMessageStatus )
از این متد برای واکشی ، وضعیت لیست پیام های ارسالی استفاده می شود.
نام پارامتر | نوع پارامتر | توضیحات |
messageId | String[] | شناسه گروه ارسال پیام |
نمونه کد فراخوانی:
raygansms.CorrespondingMessageStatus(MessageIDs);
6-دریافت شناسه گروه پیام ( متد GetGroupMessageId )
از این متد برای دریافت ، شناسه گروه پیام ارسالی استفاده می شود.
نام پارامتر | نوع پارامتر | توضیحات |
groupId | String | شناسه ارسال پیام کاربر |
نمونه کد فراخوانی:
raygansms.GetGroupMessageId(UserGroupID);
7-پیام های دریافتی ( متد ReceiveMessages )
از این متد برای واکشی ، لیست پیام های در یافتی استفاده می شود.
نام پارامتر | نوع پارامتر | توضیحات |
phoneNumber | String | شماره اختصاصی |
startDate | Long | تاریخ شروع به صورت TimeStamp |
EndDate | Long | تاریخ پایان به صورت TimeStamp |
page | int | شماره صفحه |
نمونه کد فراخوانی:
raygansms.ReceiveMessages(PhoneNumber, (System.currentTimeMillis() - (60 \* 60 \* 24 \* 60)) / 1000L,System.currentTimeMillis() / 1000L, 1);
8-دریافت اعتبار ( متد GetCredit )
از این متد برای واکشی ، اعتبار کاربر استفاده می شود.
نمونه کد فراخوانی:
raygansms.GetCredit();
9-قیمت پیامک ( متد GetPrices )
از این متد برای واکشی تعرفه ارسال پیامک توسط کاربر استفاده می شود.
نمونه کد فراخوانی:
raygansms.GetPrices();
بررسی شماره ها در لیست سیاه ( متد ShowWhiteList )
خروجی متد زیر لیست شماره موبایل هایی است که در لیست سیاه قرار ندارند.
نام پارامتر | نوع پارامتر | توضیحات |
Mobiles | String[] | لیستی از شماره موبایل ها برای بررسی |
نمونه کد فراخوانی:
raygansms.ShowWhiteList(Mobiles);
تفسیر کد های خروجی
نوع ResultCode | کد خطا | توضیح خطا |
---|---|---|
Success | 0 | عملیات با موفقیت انجام شد |
DocError | 1001 | فرمت سند ارسالی صحیح نمی باشد |
NumberError | 1002 | شماره اختصاصی وارد شده معتبر نمی باشد |
DateError | 1003 | فرمت تاریخ ارسالی صحیح نمی باشد |
ParamError | 1004 | پارامتر های ارسالی برای درخواست مورد نظر معتبر نمی باشد |
OwnNumberError | 2001 | مالکیت شماره اختصاصی مورد نظر برای کاربری وارد شده معتبر نمی باشد |
UserError | 2002 | کاربری مورد نظر مجوز استفاده از وب سرویس را ندارد |
IPError | 2003 | آدرس آی پی ، درخواست دهنده غیر مجاز می باشد |
DateRangeError | 2004 | تاریخ ارسال در نظر گرفته شده در محدوده مجاز نمی باشد |
UserListError | 2005 | تعداد مخاطبین حداکثر می تواند50000عدد باشد |
MessageLengthError | 2006 | طول پیام نمی تواند بیش از10پیام باشد |
PortError | 2007 | مقدار وارد شده برای شماره پورت غیر مجار می باشد |
PageError | 2008 | مقدار وارد شده برای شماره صفحه غیر مجاز میباشد |
UserInfoError | 2009 | خطا در واکشی اطلاعات کاربری |
RegisterInfoError | 3001 | خطا در ثبت اطلاعات |
GroupError | 3002 | خطا در دریافت گروه پیام |
CreditError | 3003 | اعتبار کافی نمی باشد |
ServiceError | 3004 | سرویس مورد نظر برای اپراتور مد نظر ، تعریف نشده است |
ServerError | 5001 | به دلیل خطای داخلی ، سرور قادر به پاسخگویی نیست |
SendError | 5002 | در هنگام ارسال پیام خطایی رخ داده است |
ReceiveError | 5003 | در هنگام دریافت نتیجه ارسال پیام خطایی رخ داده است |
ParamSendError | 5004 | برخی پیام ها در هنگام ارسال با خطا مواجه شده اند |
10-ارسال پیامک آنی و سریع (وب سرویس احراز هویت پیامکی) ارسال خودکار کد فعال سازی بابت احراز هویت(متد AutoSendCode)
نام پارامتر | نوع پارامتر | توضیحات |
phoneNumber | String | شماره موبایلی که قرار است کد فعال سازی به آن ارسال شود |
footer | String | متنی که تمایل دارید در انتهای پیامک فعال سازی شما ارسال شود، مانند Raygansms.com درصورت تمایل می توانید این مقدار را خالی ارسال نمایید |
نمونه پیامک ارسالی این متد:
با سلام ، کد تایید شما : 247944 Raygansms.com
مقدار بازگشتی این متد یک عدد بزرگتر 2000 می باشد که با این عدد می توانید با وب سرویس قدیمی اقدام به دریافت وضعیت پیامک ارسالی نمایید. در ضمن این کد هیچ ارتباطی به کد فعال سازی ندارد و با آن فرق دارد.
11-متد بررسی صحت کد فعال سازی (متد CheckSendCode)
نام پارامتر | نوع پارامتر | توضیحات |
reciptionNumber | String | شماره موبایلی که کد فعال سازی به آن ارسال شده است |
code | String | کد که برای کاربر ارسال شده و او این کد را در نرم افزار و یا سایت شما وارد کرده است |
12-ارسال کد فعال سازی دلخواه بابت احراز هویت (متد SendMessageWithCode)
نام پارامتر | نوع پارامتر | توضیحات |
reciptionNumber | String | شماره موبایلی که قرار است کد فعال سازی به آن ارسال شود |
code | String | متنی که شامل کد فعال سازی می باشد مثلا :کد فعال سازی شما : 123456 Raygansms |
مقدار بازگشتی این متد یک عدد بزرگتر 2000 می باشد که با این عدد می توانید با وب سرویس قدیمی اقدام به دریافت وضعیت پیامک ارسالی نمایید. در ضمن این کد هیچ ارتباطی به کد فعال سازی ندارد و با آن فرق دارد.
🔗 لینک دانلود نمونه کد جاوا رایگان اس ام اس
🔗 لینک Github نمونه کد جاوا برای اس ام اس
مشاوره شما افتخار❤️ماست